home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / mmdf / mmdf-IIb.43 / doc / table.sample.k < prev    next >
Encoding:
Text File  |  1986-10-02  |  13.2 KB  |  544 lines
  1.         Host and Domain Table examples
  2.  
  3.         Steve Kille
  4.  
  5.         Febraury 1984
  6.  
  7. This text is meant to illustrate by example, the mechanism for
  8. setting up host and domain tables.   It is assumed that the
  9. manual pages tailor(5.mmdf) tables(5.mmdf) have been read if
  10. not understood.   This sheet contains three example:
  11.  1) A simple Arpa host with minimal tables
  12.  2) A UK host, illustrating handling of local domain with more
  13.         than two components, and basic use of the list channel
  14.  3) A complex example, illustrating use of locmachine, and various
  15.         other subtle points
  16.  
  17. WARNING:  Some of the material here is out of date.  Consult the samples
  18. directory for other example tables.
  19.  
  20.  
  21. 1.  Basic ARPA host
  22.  
  23. The following tailor values are assumed in these examples:
  24.  
  25. LOCDOMAIN       = ARPA
  26. LOCNAME         = Ivy
  27.  
  28.  
  29. For reference in the following tables, the structure is based
  30. on the following table, channel, and domain specifications.
  31.  
  32. # Only one domain entry needed.  The table maps to a file, and
  33. # then MDMN specifies the entry.  Note that the flags entry is
  34. # probably redundant, but must always be set to 01.
  35.  
  36. MTBL    "ARPA",file="arpa",show="ARPA Domain"
  37. MDMN    "ARPA",show="ARPA Domain",table="ARPA"
  38.  
  39. # Channel parameters, with fields not pertinent to address lookup removed
  40.  
  41. MCHN  local    show="Local Channel"
  42.  
  43. MCHN  smtp  show="SMTP channel"
  44.  
  45.  
  46. First the channel tables will be looked at.  When domains are
  47. reformatted, either host or domain values are output.  The
  48. selection of host names is related to current DCA and JNT
  49. domain policy.  Domains that are 'allowed' are also host names.
  50. In other cases, abbreviated names are used.
  51.  
  52.  
  53. # Local channel table
  54.  
  55. # note - RHS = LOCNAME in all cases
  56. # values for LHS include LOCNAME, and all full domain names
  57. # Northing else should ever be needed
  58. ivy.arpa:ivy
  59. ivy:ivy
  60.  
  61. # TCP/SMTP hosts channel table
  62.  
  63.  
  64. # Only official HOST names in table
  65. alta-coma.arpa:3.1.0.50
  66. yuma.arpa:6.1.0.1
  67. bbncca.arpa:8.0.0.2
  68. bbnccb.arpa:8.1.0.2
  69. bbnccc.arpa:8.2.0.2
  70. bbnccd.arpa:8.3.0.2
  71. bbn-labs-admin.arpa:8.4.0.2
  72. bbncck.arpa:8.5.0.2
  73. .....
  74.  
  75.  
  76. #  ARPA Domain table
  77.  
  78.  
  79. #
  80. # Here are all of the names from hosts.txt
  81. # Official name first.  HOST  name (as used in channel table) on RHS
  82. alta-coma:alta-coma.arpa
  83. yuma:yuma.arpa
  84. bbncca:bbncca.arpa
  85. bbnccb:bbnccb.arpa
  86. bbnccc:bbnccc.arpa
  87. bbnccd:bbnccd.arpa
  88. bbn-labs-admin:bbn-labs-admin.arpa
  89. bbn-labs:bbn-labs-admin.arpa
  90. bbnl:bbn-labs-admin.arpa
  91. bbncck:bbncck.arpa
  92. ......
  93.  
  94.  
  95.  
  96.  
  97. 2.  Baisc UK Host
  98.  
  99. The following tailor values are assumed in these examples:
  100.  
  101. LOCDOMAIN       = Camford.AC.UK
  102. LOCNAME         = CS
  103.  
  104.  
  105. For reference in the following tables, the structure is based
  106. on the following table, channel, and domain specifications.
  107.  
  108.  
  109. #  Camford.AC.UK - always the most local domain first.  The table
  110. #  maps to a file, and the domin spec points to the table
  111. # This domain is for other hosts within the camford domain
  112. # (e.g physics.camford.ac.uk)
  113.  
  114. MTBL    "Camford",file="camford",show="camford.ac.uk domain table"
  115. MDMN    "Camford.AC.UK",show="Camford.AC.UK domain",table="Camford"
  116.  
  117. # Then The AC.UK domain for other .AC.UK domains
  118.  
  119. MTBL    "AC-UK",file="ac-uk",show="AC.UK Domain"
  120. MDMN    "AC.UK",show="AC.UK Domain",table="AC-UK"
  121.  
  122.  
  123. # then AC.UK domain, which uses the same table as AC.UK
  124. # The settings of name=AC  and dmn=AC.UK will let
  125. # foo.ac  be mapped to foo.ac.uk
  126.  
  127. MDMN    "AC",show="AC.UK Domain (AC)",table="AC-UK",name="AC",dmn="AC.UK"
  128.  
  129.  
  130. # Channel parameters, with fields not pertinent to address lookup removed
  131.  
  132. MCHN  local    show="Local Channel"
  133.  
  134. MCHN  list    show="via List-Channel"
  135.  
  136. # in this case, the list channel will use the local channel
  137. # table, rather than needing its own table.  If foo is a list,
  138. # The alis file would have entries:
  139. #       foo:foo-outbound@camford@list
  140. #       foo-outbound: :include:/etc/alias/foo
  141. # This would force foo to be deliverd to the list channel.
  142. # The list is then expanded in background
  143.  
  144. MCHN  niserc   show="via Sercnet with NIFTP"
  145.  
  146. MCHN uucp  show="with UUCP"
  147.  
  148.  
  149.  
  150. First the channel tables will be looked at.  When domains are
  151. reformatted, either host or domain values are output.  The
  152. selection of host names is related to current JNT
  153. domain policy.  Domains that are 'allowed' are also host names.
  154. In other cases, abbreviated names are used.  (e.g. until the
  155. NRS is introduced, hostnames are foo rather than foo.ac.uk).
  156.  
  157. NOTE on NRS ordering (Americans ignore this): Internal tables
  158. all use RFC 819 ordering.  Mapping for reformatting output
  159. should be selected.
  160.  
  161.  
  162. # Local channel table
  163.  
  164. # note - RHS = LOCNAME in all cases
  165. # values for LHS include LOCNAME, and all full domain names
  166. cs.camford.ac.uk:cs
  167. cs:cs
  168.  
  169.  
  170.  
  171.  
  172. # Sercnet Table
  173.  
  174. # Note that RHS is mapped to a Transport address by the lower
  175. # level (NIFTP)
  176. #
  177. #  As neither DCA nor JNT would like to see names with .AC.UK
  178. # in, UK host names are not full domains.
  179. abxa:abxa/mail
  180. apca:apca/mail
  181. baca:baca/mail
  182. # Some other camford hosts are reached over sercnet
  183. bio.camford:bio.camford/mail
  184.  
  185. # UUCP table
  186.  
  187. # This might be used for both remote and camford hosts
  188. eagle:eagle
  189. physics.camford:camphys
  190.  
  191.  
  192.  
  193. The rest of this sample description shows the structuring of
  194. the domain tables.
  195.  
  196.  
  197. #  Camford.AC.UK domain table
  198.  
  199.  
  200. # This contains all *.camford.ac.uk
  201. # with alternative anmes on LHS, and HOST names on RHS
  202. # Official names first
  203. # Ourselves - note lowercase in tables
  204. cs:cs
  205. comp-sci:cs
  206. # And the rest
  207. bio:bio.camford
  208. biology:bio.camford
  209. physics:physics.camford
  210.  
  211.  
  212.  
  213.  
  214. # AC.UK Domain table
  215.  
  216.  
  217. #
  218. #    List of *.AC.UK
  219. # Note that some are in different channels
  220. abxa:abxa
  221. apca:apca
  222. baca:baca
  223. eagle:eagle
  224.  
  225.  
  226.  
  227. 3.  Complex Example
  228.  
  229. A real extract is given, as this is more straightforeward to
  230. check!
  231.  
  232. The following tailor values are assumed in these examples:
  233.  
  234. LOCDOMAIN       = AC.UK
  235. LOCNAME         = Ucl-Cs
  236. LOCMACHINE      = 44a
  237.  
  238.  
  239. This mechanism should still work if LOCMACHINE is not set.
  240. For reference in the following tables, the structure is based
  241. on the following table, channel, and domain specifications.
  242.  
  243.  
  244. #  Ucl-Cs.AC.UK - always the most local domain first.  The table
  245. #  maps to a file, and the domin spec points to the table
  246.  
  247. MTBL    "Ucl-Cs",file="ucl-cs",show="Ucl-Cs domain table"
  248. MDMN    "Ucl-Cs.AC.UK",show="Ucl-Cs.AC.UK domain",table="Ucl-Cs"
  249.  
  250. # Then AC.UK
  251.  
  252. MTBL    "AC-UK",file="ac-uk",show="AC.UK Domain"
  253. MDMN    "AC.UK",show="AC.UK Domain",table="AC-UK"
  254.  
  255. # then AC domain, which uses the same table as AC.UK
  256. # The settings of name=AC  and dmn=AC.UK will let
  257. # foo.ac  be mapped to foo.ac.uk
  258.  
  259. MDMN    "AC",show="AC.UK Domain (AC)",table="AC-UK",name="AC",dmn="AC.UK"
  260.  
  261. MTBL    "ARPA",file="arpa",show="ARPA Domain"
  262. MDMN    "ARPA",show="ARPA Domain",table="ARPA"
  263.  
  264. MTBL    "MAILNET",file="mailnet",show="Mailnet Domain"
  265. MDMN    "MAILNET",show="Mailnet Domain",table="MAILNET"
  266.  
  267. # The top level domain is entered by setting Name and dmn to ""
  268.  
  269. MTBL    "Top-Level",file="top",show="Top Level Domain"
  270. MDMN    "Top-Level",show="Top level Domain",table="Top-Level",name="",dmn=""
  271.  
  272.  
  273. # Channel parameters, with fields not pertinent to address lookup removed
  274.  
  275. MCHN  local    show="Local (44a)"
  276.  
  277. MCHN  list    show="via List-Channel"
  278.  
  279. MCHN  sring show="with SMTP"  (around local ring)
  280.  
  281. MCHN  satnet  show="via Satnet with SMTP",ldomain="ARPA"
  282.  
  283. MCHN  niserc   show="via Sercnet with NIFTP"
  284.  
  285.  
  286.  
  287. First the channel tables will be looked at.  When domains are
  288. reformatted, either host or domain values are output.  The
  289. selection of host names is related to current DCA and JNT
  290. domain policy.  Domains that are 'allowed' are also host names.
  291. In other cases, abbreviated names are used.
  292.  
  293.  
  294. # Local channel table
  295.  
  296. # note - RHS = LOCNAME in all cases
  297. # values for LHS include LOCNAME, and all full domain names
  298. ucl-cs:ucl-cs
  299. ucl-cs.ac.uk:ucl-cs
  300. ucl-cs.arpa:ucl-cs
  301. # These two ar only needed if LOCMACHINE is set
  302. # The LHS should be LOCMACHINE and LOC-MACHINE+NAME+DOMAIN
  303. 44a:ucl-cs
  304. 44a.ucl-cs.ac.uk:ucl-cs
  305.  
  306.  
  307. # List channel table
  308.  
  309. # This has only one entry, and is only needed if LOCMACHINE is
  310. # set to give transparent routing between a number  of machines
  311. # This enables lists on other machines to be referred to iin
  312. # the same manner
  313. # in this case, an alis file entry might be
  314. #       foo:foo-outbound@44c-list
  315. #       foo-outbound: :include: /etc/alias/foo@44c
  316. # The @44c in the second line ensures that mail sent to foo-outbound
  317. # works correctly
  318. 44a-list:44a-list
  319.  
  320.  
  321. # Ring channel table (abbreviated)
  322.  
  323.  
  324. # This is the table associated with the local ring
  325. # The local references need NOT be removed, and so all machines
  326. # can use the same table.  These names are not seen by
  327. # users unless typed explicity.  RHS is transport address.
  328. ucl-cs.arpa:128.16.9.3
  329. 44a:smtp44a
  330. 44b:smtp44b
  331. 44c:smtp44c
  332. ...
  333. # References to other list channels are included so that non-local
  334. # lists will be sent around the local net to the next machine
  335. 44a-list:smtp44a
  336. 44b-list:smtp44b
  337. 44c-list:smtp44c
  338. ...
  339.  
  340.  
  341.  
  342. # TCP/SMTP hosts channel table
  343.  
  344.  
  345. # Note special reference to ourselves at the top of the table
  346. # To protect against table update errors
  347. # NOte that multiples of the RHS are included to do the
  348. # reverse mapping correctly from all registered IP addresses
  349. ucl-cs.arpa:128.16.9.3
  350. ucl-cs.arpa:14.0.0.9
  351. # This is needed for convenient loopback testing
  352. # (e.g to use steve@ucl-cs@satnet  rather than steve@ucl-cs.arpa@satnet
  353. ucl-cs:128.16.9.3
  354. #
  355. #    Arpa hosts are all full domain names.   RHS is familiar numbers
  356. #  Note that no abbreviated names are in this table
  357. alta-coma.arpa:3.1.0.50
  358. yuma.arpa:6.1.0.1
  359. bbncca.arpa:8.0.0.2
  360. bbnccb.arpa:8.1.0.2
  361. bbnccc.arpa:8.2.0.2
  362. bbnccd.arpa:8.3.0.2
  363. bbn-labs-admin.arpa:8.4.0.2
  364. bbncck.arpa:8.5.0.2
  365. .....
  366.  
  367.  
  368.  
  369. # Sercnet Table
  370.  
  371. # Note that RHS is mapped to a Transport address by the lower
  372. # level (NIFTP)
  373. #
  374. #  As neither DCA nor JNT would like to see names with .AC.UK
  375. # in, UK host names are not full domains.
  376. abxa:abxa/mail
  377. apca:apca/mail
  378. baca:baca/mail
  379. bdga:bdga/mail
  380. bdgb:bdgb/mail
  381. bedford:bedford/mail
  382. bgxa:bgxa/mail
  383. bhga:bhga/mail
  384. bhgb:bhgb/mail
  385. bhia:bhia/mail
  386. bhvs:bhvs/mail
  387. bihh1:bihh1/mail
  388. bihh2:bihh2/mail
  389. bihh3:bihh3/mail
  390. # UK users - note domain ordering!!
  391. # US users - ignore this entry
  392. hcig.nott:nott.hcig/mail
  393. nsga:nsga/mail
  394.  
  395.  
  396.  
  397.  
  398.  
  399. The rest of this sample description shows the structuring of
  400. the domain tables.
  401.  
  402.  
  403. #  UCL-CS.AC.UK domain table
  404.  
  405.  
  406. # Map all known names below the (transparent) UCL-CS.AC.UK
  407. # Thus string 44b maps into DOMAIN 44b.UCL-CS.AC.UK
  408. # which maps into HOST 44b
  409. # which is found in the ring channel  table
  410. # (or in the case of 44a in the local channel  table or 44a-list
  411. # in the list channel table)
  412. 44a:44a
  413. 44b:44b
  414. 44c:44c
  415. .....
  416. 44a-list:44a-list
  417. 44b-list:44b-list
  418. 44c-list:44c-list
  419. ....
  420.  
  421.  
  422.  
  423.  
  424.  
  425. #  ARPA Domain table
  426.  
  427.  
  428. # idis is at top of file as it is used as a relay host
  429. #  A relays entry must come before any hosts realying
  430. # through it to get the official name correct
  431. usc-isid:usc-isid.arpa
  432. #
  433. #  The following hosts  won't talk TCP to UCL
  434. # (or used not to at least).  Therefore we palm them off
  435. # on someone else (boo hiss)
  436. ada-vax:ada-vax.arpa,usc-isid.arpa
  437. isi-vaxb:ada-vax.arpa,usc-isid.arpa
  438. ajpo:ada-vax.arpa,usc-isid.arpa
  439. vaxb:ada-vax.arpa,usc-isid.arpa
  440. almsa-1:almsa-1.arpa,usc-isid.arpa
  441. alta-coma:alta-coma.arpa,usc-isid.arpa
  442. ames-tss:ames-tss.arpa,usc-isid.arpa
  443. ames-67:ames-tss.arpa,usc-isid.arpa
  444. #
  445. # Here are all of the names from hosts.txt
  446. # Official name first.  Host name on RHS
  447. alta-coma:alta-coma.arpa
  448. yuma:yuma.arpa
  449. bbncca:bbncca.arpa
  450. bbnccb:bbnccb.arpa
  451. bbnccc:bbnccc.arpa
  452. bbnccd:bbnccd.arpa
  453. bbn-labs-admin:bbn-labs-admin.arpa
  454. bbn-labs:bbn-labs-admin.arpa
  455. bbnl:bbn-labs-admin.arpa
  456. bbncck:bbncck.arpa
  457.  
  458.  
  459. # Mailnet Domain table
  460.  
  461.  
  462. # All domains are reached through MIT relay
  463. # the official name of mit-multics si found in
  464. # the Arpa domain
  465. # There is no need for a mailnet channel
  466. carnegie:carnegie.mailnet,mit-multics.arpa
  467. cornella:cornella.mailnet,mit-multics.arpa
  468. dickinson:dickinson.mailnet,mit-multics.arpa
  469. durham:durham.mailnet,mit-multics.arpa
  470. educom:educom.mailnet,mit-multics.arpa
  471.  
  472.  
  473.  
  474. # AC.UK Domain table
  475.  
  476.  
  477. #  Lots of amazing names for UCL at the top
  478. ucl-cs:ucl-cs
  479. ucl:ucl-cs
  480. zuxa:ucl-cs
  481. zuxa80:ucl-cs
  482. research:ucl-cs
  483. nss:ucl-cs
  484. unknown-host:ucl-cs
  485. zuxc:ucl-cs
  486. ucl-niftp:ucl-cs
  487. ucl-tg:ucl-cs
  488. src-44a:44c
  489. #
  490. #    Some odinary domain names
  491. abxa:abxa
  492. apca:apca
  493. baca:baca
  494. bdga:bdga
  495. bdgb:bdgb
  496. bedford:bedford
  497. bgxa:bgxa
  498. #  These entries will map HCIG.NOTT, HCIG.NOTTINGHAM
  499. #  NOTT, NOTTINGHAM, HCIG (and all the permutations with .AC or
  500. #  .AC.UK appended) into HCIG.NOTT.AC.UK
  501. hcig.nott:hcig.nott
  502. hcig.nottingham:hcig.nott
  503. nottingham:hcig.nott
  504. nott:hcig.nott
  505. hcig:hcig.nott
  506. #
  507. #  Some examples of Relayed connections.
  508. # Note that the rightmost component should be the host
  509. #  directly connected to.  The leftmost component should be
  510. # The Name required for 'Host' format output
  511. dlia:dlia,rlgb
  512. rlia:rlia,rlgb
  513. rlib:rlib,rlgb
  514. camphx:camphx,caga
  515. caxa:camphx,caga
  516. #  Camring is routed first ot caga, then camjenny, finally to camring
  517. camring:camring,camjenny.ac.uk,caga
  518. camjenny:camjenny,caga
  519. camsteve:camsteve,caga
  520. ecsvax:ecsvax,edxa
  521. rco:rco,edxa
  522. edxd:rco,edxa
  523. eagle:eagle,ukc.ac.uk,rco.ac.uk,edxa
  524. ktda:eagle,ukc.ac.uk,rco.ac.uk,edxa
  525. kent:eagle,ukc.ac.uk,rco.ac.uk,edxa
  526. #
  527. #    Hosts connected to over the PSS Network
  528. aucc:aucc
  529. cardiff:cardiff
  530. cardf:cardiff
  531. essex:essex
  532.  
  533.  
  534. #  Top level domain
  535.  
  536. #  UUCP and Bitnet through berkeley gateway
  537. #  Note that the HOST name of the relay must be given
  538. uucp:ucb-vax.arpa
  539. bitnet:ucb-vax.arpa
  540. # Mailnet relay through MIT.  Domains in the mailnet table can
  541. # be abbreviated.  Others will only work if specified in full
  542. mailnet:mit-multics.arpa
  543.  
  544.